<!DOCTYPE html>
<html lang="en-US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<title>read_aop_knowledge [HALCON算子参考手册]</title>
<style type="text/css">
      body {
    color: #000000;
    background-color: #ffffff;
    margin: 0;
    font-family: Arial, Helvetica, sans-serif;
}

.body_main {
    margin-left: 35px;
    margin-right: 35px;
}

@media screen and (min-width:992px) {

    .body_main {
        margin-left: 10%;
        margin-right: 10%;
    }

    table.toctable {
        width: 80%
    }
}

@media screen and (min-width:1400px) {

    .body_main {
        margin-left: 15%;
        margin-right: 15%;
    }

    table.toctable {
        width: 70%
    }
}

body>div ul ul {
    margin-left: inherit;
}

a:link {
    color: #0044cc;
}

a:link,
a:visited {
    text-decoration: none;
}

a:link:hover,
a:visited:hover {
    text-decoration: underline;
}

th {
    text-align: left;
}

h1,
h2,
h3,
h4,
h5,
h6 {
    text-rendering: optimizeLegibility;
    color: #666666;
}

code {
    font-family: monospace,monospace;
}

h1 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

h2 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

hr {
    border: 0;
    border-top: solid 1px #f28d26;
}

.pre {
    display: block;
    padding-bottom: 1ex;
    font-family: monospace;
    white-space: pre;
}

pre {
    font-family: monospace, monospace;
    padding: 1ex;
    white-space: pre-wrap;
}

.toc {
    font-size: 80%;
    border-top: 1px dashed #f28d26;
    border-bottom: 1px dashed #f28d26;
    padding-top: 5px;
    padding-bottom: 5px;
}

.inv {
    margin: 0;
    border: 0;
    padding: 0;
}

.banner {
    color: #666666;
    padding-left: 1em;
}

.logo {
    background-color: white;
}

.keyboard {
    font-size: 80%;
    padding-left: 3px;
    padding-right: 3px;
    border-radius: 5px;
    border-width: 1px;
    border-style: solid;
    border-color: #f28d26;
    background-color: #f3f3f3;
}

.warning {
    margin-top: 2ex;
    margin-bottom: 1ex;
    padding: 10px;
    text-align: center;
    border: 1px solid;
    color: #bb0000;
    background-color: #fff7f7
}

.imprint {
    margin-top: 1ex;
    font-size: 80%;
    color: #666666;
}

.imprinthead {
    font-weight: bolder;
    color: #666666;
}

.indexlink {
    text-align: right;
    padding-bottom: 5px;
}

.postscript {
    margin-top: 2ex;
    font-size: 80%;
    color: #666666
}

.evenrow {
    background-color: #e7e7ef;
    vertical-align: top;
}

.oddrow {
    background-color: #f7f7ff;
    vertical-align: top;
}

.headrow {
    background-color: #97979f;
    color: #ffffff;
    vertical-align: top;
}

.logorow {
    vertical-align: top;
}

.error {
    color: red;
}

.var {
    font-style: italic
}

.halconoperator {
    font-family: monospace, monospace;
}

span.operator {
    font-family: monospace, monospace;
}

span.procedure {
    font-family: monospace, monospace;
}

span.operation {
    font-family: monospace, monospace;
}

span.feature {
    font-family: Arial, Helvetica, Homerton, sans-serif;
}

ul {
    padding-left: 1.2em;
}

li.dot {
    list-style-type: square;
    color: #f28d26;
}

.breadcrumb {
    font-size: 80%;
    color: white;
    background-color: #062d64;
    margin-bottom: 20px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 15px;
}

.webbar {
    font-size: 80%;
    background-color: #dddddd;
    margin-top: 0px;
    margin-left: -35px;
    margin-right: -35px;
    margin-bottom: 0px;
    padding-top: 5px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 5px;
}

.footer {
    display: flex;
    flex-wrap: wrap;
    justify-content: space-between;
    border-top: 1px dashed #f28d26;
    font-size: 80%;
    color: #666666;
    padding-bottom: 8px;
}

.footer .socialmedia a {
    padding-left: 7px;
}

.socialmedia {
    padding-top: 10px;
}

.copyright {
    margin-top: 19px;
}

.breadcrumb a {
    color: #ffffff;
    border-bottom: 1px solid white;
}

.breadcrumb a:link:hover,
.breadcrumb a:visited:hover {
    text-decoration: none;
    border-bottom: none;
}

.heading {
    margin-top: 1ex;
    font-size: 110%;
    font-weight: bold;
    color: #666666;
}

.text {
    color: black;
}

.example {
    font-size: 80%;
    background-color: #f3f3f3;
    border: 1px dashed #666666;
    padding: 10px;
}

.displaymath {
    display: block;
    text-align: center;
    margin-top: 1ex;
    margin-bottom: 1ex;
}

.title {
    float: left;
    padding-top: 3px;
    padding-bottom: 3px;
}

.signnote {
    font-family: Arial, Helvetica, Homerton, sans-serif;
    font-size: 80%;
    color: #666666;
    font-weight: lighter;
    font-style: italic
}

.par {
    margin-bottom: 1.5em;
}

.parhead {
    text-align: right;
}

.parname {
    float: left;
}

.pardesc {
    font-size: 85%;
    margin-top: 0.5em;
    margin-bottom: 0.5em;
    margin-left: 2em;
}

.parcat {
    color: #666;
    font-weight: bold;
}

*[data-if=cpp],
*[data-if=c],
*[data-if=dotnet],
*[data-if=com],
*[data-if=python] {
    display: none;
}

.tabbar {
    text-align: right;
    border-bottom: 1px solid #f28d26;
    margin-bottom: 0.5em;
}

ul.tabs {
    padding-top: 3px;
    padding-bottom: 3px;
    margin-top: 10px;
    margin-bottom: 0;
    font-size: 80%
}

ul.tabs li {
    padding-top: 3px;
    padding-bottom: 3px;
    display: inline;
    overflow: hidden;
    list-style-type: none;
    margin: 0;
    margin-left: 8px;
    border-top: 1px solid #666;
    border-left: 1px solid #666;
    border-right: 1px solid #666;
}

ul.tabs li.active {
    border-left: 1px solid #f28d26;
    border-right: 1px solid #f28d26;
    border-top: 1px solid #f28d26;
    border-bottom: 1px solid #fff;
}

ul.tabs li.inactive {
    background-color: #eee;
}

ul.tabs li a {
    padding-left: 5px;
    padding-right: 5px;
    color: #666;
}

ul.tabs li a:link:hover {
    text-decoration: none;
}

ul.tabs li.inactive a {
    color: #666;
}

ul.tabs li.active a {
    color: black;
}

dl.generic dd {
    margin-bottom: 1em;
}

.pari {
    color: olive;
}

.paro {
    color: maroon;
}

.comment {
    font-size: 80%;
    color: green;
    white-space: nowrap;
}

table.grid {
    border-collapse: collapse;
}

table.grid td {
    padding: 5px;
    border: 1px solid;
}

table.layout {
    border: 0px;
}

table.layout td {
    padding: 5px;
}

table.table {
    border-collapse: collapse;
}

table.table td {
    padding: 5px;
    border-left: 0px;
    border-right: 0px;
}

table.table tr:last-child {
    border-bottom: 1px solid;
}

table.table th {
    padding: 5px;
    border-top: 1px solid;
    border-bottom: 1px solid;
    border-left: 0px;
    border-right: 0px;
}

.details_summary {
    cursor: pointer;
}

table.toctable {
    width: 100%;
}

table.toctable col:first-child {
    width: 20%;
}

table.toctable col:nth-last-child(2) {
    width: 8%;
}

table.altcolored tr:nth-child(even) {
    background-color: #f3f3f3;
}

    </style>
<!--OP_REF_STYLE_END-->
<script>
    <!--
var active_lang='hdevelop';function switchVisibility(obj,active_lang,new_lang)
{var display_style='inline';
for(var i=0;i<obj.length;i++)
{if(obj.item(i).getAttribute('data-if')==new_lang)
{obj.item(i).style.display=display_style;}
if(obj.item(i).getAttribute('data-if')==active_lang)
{obj.item(i).style.display='none';}}
return;}
function toggleLanguage(new_lang,initial)
{if(active_lang!=new_lang)
{var lis=document.getElementsByTagName('li');for(var i=0;i<lis.length;i++)
{if(lis.item(i).id=='syn-'+new_lang)
{lis.item(i).className='active';}
else
{lis.item(i).className='inactive';}}
var divs=document.getElementsByTagName('div');var spans=document.getElementsByTagName('span');switchVisibility(divs,active_lang,new_lang);switchVisibility(spans,active_lang,new_lang);if(!initial)
{setCookie("halcon_reference_language",new_lang,null,null);}
active_lang=new_lang;}
return;}
function setCookie(name,value,domain,exp_offset,path,secure)
{localStorage.setItem(name,value);}
function getCookie(name)
{return localStorage.getItem(name);}
function initialize()
{var qs=location.href.split('?')[1];var qs_lang_raw=location.href.split('interface=')[1];var qs_lang;if(qs_lang_raw)
{qs_lang=qs_lang_raw.split('#')[0];}
var cookie_lang=getCookie("halcon_reference_language");var new_lang;if((qs_lang=="hdevelop")||(qs_lang=="dotnet")||(qs_lang=="python")||(qs_lang=="cpp")||(qs_lang=="c"))
{new_lang=qs_lang;setCookie("halcon_reference_language",new_lang,null,null);}
else if((cookie_lang=="hdevelop")||(cookie_lang=="dotnet")||(cookie_lang=="python")||(cookie_lang=="cpp")||(cookie_lang=="c"))
{new_lang=cookie_lang;}
else
{new_lang="hdevelop";}
toggleLanguage(new_lang,1);return;}
-->

  </script>
</head>
<body onload="initialize();">
<div class="breadcrumb">
<br class="inv"><a href="index.html">目录</a> / <a href="toc_system.html">系统</a> / <a href="toc_system_parallelization.html">Parallelization</a><br class="inv">
</div>
<div class="body_main">
<div class="tabbar"><ul class="tabs">
<li id="syn-hdevelop" class="active"><a href="javascript:void(0);" onclick="toggleLanguage('hdevelop')" onfocus="blur()">HDevelop</a></li>
<li id="syn-dotnet" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('dotnet')" onfocus="blur()">.NET</a></li>
<li id="syn-python" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('python')" onfocus="blur()">Python</a></li>
<li id="syn-cpp" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('cpp')" onfocus="blur()">C++</a></li>
<li id="syn-c" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('c')" onfocus="blur()">C</a></li>
</ul></div>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<!--OP_REF_HEADER_END-->
<h1 id="sec_name">
<span data-if="hdevelop" style="display:inline;">read_aop_knowledge</span><span data-if="c" style="display:none;">T_read_aop_knowledge</span><span data-if="cpp" style="display:none;">ReadAopKnowledge</span><span data-if="dotnet" style="display:none;">ReadAopKnowledge</span><span data-if="python" style="display:none;">read_aop_knowledge</span> (算子名称)</h1>
<h2>名称</h2>
<p><code><span data-if="hdevelop" style="display:inline;">read_aop_knowledge</span><span data-if="c" style="display:none;">T_read_aop_knowledge</span><span data-if="cpp" style="display:none;">ReadAopKnowledge</span><span data-if="dotnet" style="display:none;">ReadAopKnowledge</span><span data-if="python" style="display:none;">read_aop_knowledge</span></code> — Load knowledge about hardware dependent behavior of automatic operator
parallelization.</p>
<h2 id="sec_synopsis">参数签名</h2>
<div data-if="hdevelop" style="display:inline;">
<p>
<code><b>read_aop_knowledge</b>( :  : <a href="#FileName"><i>FileName</i></a>, <a href="#GenParamName"><i>GenParamName</i></a>, <a href="#GenParamValue"><i>GenParamValue</i></a> : <a href="#Attributes"><i>Attributes</i></a>, <a href="#OperatorNames"><i>OperatorNames</i></a>)</code></p>
</div>
<div data-if="c" style="display:none;">
<p>
<code>Herror <b>T_read_aop_knowledge</b>(const Htuple <a href="#FileName"><i>FileName</i></a>, const Htuple <a href="#GenParamName"><i>GenParamName</i></a>, const Htuple <a href="#GenParamValue"><i>GenParamValue</i></a>, Htuple* <a href="#Attributes"><i>Attributes</i></a>, Htuple* <a href="#OperatorNames"><i>OperatorNames</i></a>)</code></p>
</div>
<div data-if="cpp" style="display:none;">
<p>
<code>void <b>ReadAopKnowledge</b>(const HTuple&amp; <a href="#FileName"><i>FileName</i></a>, const HTuple&amp; <a href="#GenParamName"><i>GenParamName</i></a>, const HTuple&amp; <a href="#GenParamValue"><i>GenParamValue</i></a>, HTuple* <a href="#Attributes"><i>Attributes</i></a>, HTuple* <a href="#OperatorNames"><i>OperatorNames</i></a>)</code></p>
<p>
<code>static <a href="HTuple.html">HTuple</a> <a href="HSystem.html">HSystem</a>::<b>ReadAopKnowledge</b>(const HString&amp; <a href="#FileName"><i>FileName</i></a>, const HTuple&amp; <a href="#GenParamName"><i>GenParamName</i></a>, const HTuple&amp; <a href="#GenParamValue"><i>GenParamValue</i></a>, HTuple* <a href="#OperatorNames"><i>OperatorNames</i></a>)</code></p>
<p>
<code>static <a href="HTuple.html">HTuple</a> <a href="HSystem.html">HSystem</a>::<b>ReadAopKnowledge</b>(const HString&amp; <a href="#FileName"><i>FileName</i></a>, const HString&amp; <a href="#GenParamName"><i>GenParamName</i></a>, const HString&amp; <a href="#GenParamValue"><i>GenParamValue</i></a>, HString* <a href="#OperatorNames"><i>OperatorNames</i></a>)</code></p>
<p>
<code>static <a href="HTuple.html">HTuple</a> <a href="HSystem.html">HSystem</a>::<b>ReadAopKnowledge</b>(const char* <a href="#FileName"><i>FileName</i></a>, const char* <a href="#GenParamName"><i>GenParamName</i></a>, const char* <a href="#GenParamValue"><i>GenParamValue</i></a>, HString* <a href="#OperatorNames"><i>OperatorNames</i></a>)</code></p>
<p>
<code>static <a href="HTuple.html">HTuple</a> <a href="HSystem.html">HSystem</a>::<b>ReadAopKnowledge</b>(const wchar_t* <a href="#FileName"><i>FileName</i></a>, const wchar_t* <a href="#GenParamName"><i>GenParamName</i></a>, const wchar_t* <a href="#GenParamValue"><i>GenParamValue</i></a>, HString* <a href="#OperatorNames"><i>OperatorNames</i></a>)  <span class="signnote">
            (
            Windows only)
          </span></code></p>
</div>
<div data-if="com" style="display:none;"></div>
<div data-if="dotnet" style="display:none;">
<p>
<code>static void <a href="HOperatorSet.html">HOperatorSet</a>.<b>ReadAopKnowledge</b>(<a href="HTuple.html">HTuple</a> <a href="#FileName"><i>fileName</i></a>, <a href="HTuple.html">HTuple</a> <a href="#GenParamName"><i>genParamName</i></a>, <a href="HTuple.html">HTuple</a> <a href="#GenParamValue"><i>genParamValue</i></a>, out <a href="HTuple.html">HTuple</a> <a href="#Attributes"><i>attributes</i></a>, out <a href="HTuple.html">HTuple</a> <a href="#OperatorNames"><i>operatorNames</i></a>)</code></p>
<p>
<code>static <a href="HTuple.html">HTuple</a> <a href="HSystem.html">HSystem</a>.<b>ReadAopKnowledge</b>(string <a href="#FileName"><i>fileName</i></a>, <a href="HTuple.html">HTuple</a> <a href="#GenParamName"><i>genParamName</i></a>, <a href="HTuple.html">HTuple</a> <a href="#GenParamValue"><i>genParamValue</i></a>, out <a href="HTuple.html">HTuple</a> <a href="#OperatorNames"><i>operatorNames</i></a>)</code></p>
<p>
<code>static <a href="HTuple.html">HTuple</a> <a href="HSystem.html">HSystem</a>.<b>ReadAopKnowledge</b>(string <a href="#FileName"><i>fileName</i></a>, string <a href="#GenParamName"><i>genParamName</i></a>, string <a href="#GenParamValue"><i>genParamValue</i></a>, out string <a href="#OperatorNames"><i>operatorNames</i></a>)</code></p>
</div>
<div data-if="python" style="display:none;">
<p>
<code>def <b>read_aop_knowledge</b>(<a href="#FileName"><i>file_name</i></a>: str, <a href="#GenParamName"><i>gen_param_name</i></a>: MaybeSequence[str], <a href="#GenParamValue"><i>gen_param_value</i></a>: MaybeSequence[Union[str, int, float]]) -&gt; Tuple[Sequence[str], Sequence[str]]</code></p>
<p>
<code>def <b>read_aop_knowledge_s</b>(<a href="#FileName"><i>file_name</i></a>: str, <a href="#GenParamName"><i>gen_param_name</i></a>: MaybeSequence[str], <a href="#GenParamValue"><i>gen_param_value</i></a>: MaybeSequence[Union[str, int, float]]) -&gt; Tuple[Sequence[str], str]</code></p>
</div>
<h2 id="sec_description">描述</h2>
<p><code><span data-if="hdevelop" style="display:inline">read_aop_knowledge</span><span data-if="c" style="display:none">read_aop_knowledge</span><span data-if="cpp" style="display:none">ReadAopKnowledge</span><span data-if="com" style="display:none">ReadAopKnowledge</span><span data-if="dotnet" style="display:none">ReadAopKnowledge</span><span data-if="python" style="display:none">read_aop_knowledge</span></code> loads the automatic operator parallelization
(AOP) knowledge of HALCON operators from file. The knowledge is used to
better utilize multiprocessor hardware in order to speed up the processing
of operators. To optimize the automatic operator parallelization,
HALCON needs some knowledge about the speed of operators on the used
hardware. This hardware-specific knowledge
can be obtained and stored by calling 该算子 <a href="optimize_aop.html"><code><span data-if="hdevelop" style="display:inline">optimize_aop</span><span data-if="c" style="display:none">optimize_aop</span><span data-if="cpp" style="display:none">OptimizeAop</span><span data-if="com" style="display:none">OptimizeAop</span><span data-if="dotnet" style="display:none">OptimizeAop</span><span data-if="python" style="display:none">optimize_aop</span></code></a>
and <a href="write_aop_knowledge.html"><code><span data-if="hdevelop" style="display:inline">write_aop_knowledge</span><span data-if="c" style="display:none">write_aop_knowledge</span><span data-if="cpp" style="display:none">WriteAopKnowledge</span><span data-if="com" style="display:none">WriteAopKnowledge</span><span data-if="dotnet" style="display:none">WriteAopKnowledge</span><span data-if="python" style="display:none">write_aop_knowledge</span></code></a>, respectively.
</p>
<p>With <code><span data-if="hdevelop" style="display:inline">read_aop_knowledge</span><span data-if="c" style="display:none">read_aop_knowledge</span><span data-if="cpp" style="display:none">ReadAopKnowledge</span><span data-if="com" style="display:none">ReadAopKnowledge</span><span data-if="dotnet" style="display:none">ReadAopKnowledge</span><span data-if="python" style="display:none">read_aop_knowledge</span></code>, it is possible to load this knowledge
explicitly from a binary file. In doing so, <a href="#FileName"><i><code><span data-if="hdevelop" style="display:inline">FileName</span><span data-if="c" style="display:none">FileName</span><span data-if="cpp" style="display:none">FileName</span><span data-if="com" style="display:none">FileName</span><span data-if="dotnet" style="display:none">fileName</span><span data-if="python" style="display:none">file_name</span></code></i></a> denotes the
name of this file (incl. path and file extension). If an empty string
<i><span data-if="hdevelop" style="display:inline">''</span><span data-if="c" style="display:none">""</span><span data-if="cpp" style="display:none">""</span><span data-if="com" style="display:none">""</span><span data-if="dotnet" style="display:none">""</span><span data-if="python" style="display:none">""</span></i> is passed to <a href="#FileName"><i><code><span data-if="hdevelop" style="display:inline">FileName</span><span data-if="c" style="display:none">FileName</span><span data-if="cpp" style="display:none">FileName</span><span data-if="com" style="display:none">FileName</span><span data-if="dotnet" style="display:none">fileName</span><span data-if="python" style="display:none">file_name</span></code></i></a>, HALCON reads the knowledge
from the specific file <i><span data-if="hdevelop" style="display:inline">'.aop_info'</span><span data-if="c" style="display:none">".aop_info"</span><span data-if="cpp" style="display:none">".aop_info"</span><span data-if="com" style="display:none">".aop_info"</span><span data-if="dotnet" style="display:none">".aop_info"</span><span data-if="python" style="display:none">".aop_info"</span></i> in the HALCON installation
directory (Linux) or within the common application data folder
(Windows). This file is read by HALCON automatically during the
initialization phase but can easily be re-read by
<code><span data-if="hdevelop" style="display:inline">read_aop_knowledge</span><span data-if="c" style="display:none">read_aop_knowledge</span><span data-if="cpp" style="display:none">ReadAopKnowledge</span><span data-if="com" style="display:none">ReadAopKnowledge</span><span data-if="dotnet" style="display:none">ReadAopKnowledge</span><span data-if="python" style="display:none">read_aop_knowledge</span></code>. The read knowledge updates the system's
parallelization information and can be controlled by pairs of additional
parameter values passed to <a href="#GenParamName"><i><code><span data-if="hdevelop" style="display:inline">GenParamName</span><span data-if="c" style="display:none">GenParamName</span><span data-if="cpp" style="display:none">GenParamName</span><span data-if="com" style="display:none">GenParamName</span><span data-if="dotnet" style="display:none">genParamName</span><span data-if="python" style="display:none">gen_param_name</span></code></i></a> and <a href="#GenParamValue"><i><code><span data-if="hdevelop" style="display:inline">GenParamValue</span><span data-if="c" style="display:none">GenParamValue</span><span data-if="cpp" style="display:none">GenParamValue</span><span data-if="com" style="display:none">GenParamValue</span><span data-if="dotnet" style="display:none">genParamValue</span><span data-if="python" style="display:none">gen_param_value</span></code></i></a>.
Every entry in <a href="#GenParamName"><i><code><span data-if="hdevelop" style="display:inline">GenParamName</span><span data-if="c" style="display:none">GenParamName</span><span data-if="cpp" style="display:none">GenParamName</span><span data-if="com" style="display:none">GenParamName</span><span data-if="dotnet" style="display:none">genParamName</span><span data-if="python" style="display:none">gen_param_name</span></code></i></a> must have one corresponding,
specifying entry in <a href="#GenParamValue"><i><code><span data-if="hdevelop" style="display:inline">GenParamValue</span><span data-if="c" style="display:none">GenParamValue</span><span data-if="cpp" style="display:none">GenParamValue</span><span data-if="com" style="display:none">GenParamValue</span><span data-if="dotnet" style="display:none">genParamValue</span><span data-if="python" style="display:none">gen_param_value</span></code></i></a>, meaning that the tuples
passed to the parameters must have the same length. <a href="#GenParamName"><i><code><span data-if="hdevelop" style="display:inline">GenParamName</span><span data-if="c" style="display:none">GenParamName</span><span data-if="cpp" style="display:none">GenParamName</span><span data-if="com" style="display:none">GenParamName</span><span data-if="dotnet" style="display:none">genParamName</span><span data-if="python" style="display:none">gen_param_name</span></code></i></a>
supports the values in  following list, describing the possible applicable
values for  <a href="#GenParamValue"><i><code><span data-if="hdevelop" style="display:inline">GenParamValue</span><span data-if="c" style="display:none">GenParamValue</span><span data-if="cpp" style="display:none">GenParamValue</span><span data-if="com" style="display:none">GenParamValue</span><span data-if="dotnet" style="display:none">genParamValue</span><span data-if="python" style="display:none">gen_param_value</span></code></i></a>:
</p>
<dl class="generic">

<dt><b><i><span data-if="hdevelop" style="display:inline">'ignore_attrib'</span><span data-if="c" style="display:none">"ignore_attrib"</span><span data-if="cpp" style="display:none">"ignore_attrib"</span><span data-if="com" style="display:none">"ignore_attrib"</span><span data-if="dotnet" style="display:none">"ignore_attrib"</span><span data-if="python" style="display:none">"ignore_attrib"</span></i></b></dt>
<dd>
<p>

suppresses to check knowledge attributes.
E.g., while reading the file <code><span data-if="hdevelop" style="display:inline">read_aop_knowledge</span><span data-if="c" style="display:none">read_aop_knowledge</span><span data-if="cpp" style="display:none">ReadAopKnowledge</span><span data-if="com" style="display:none">ReadAopKnowledge</span><span data-if="dotnet" style="display:none">ReadAopKnowledge</span><span data-if="python" style="display:none">read_aop_knowledge</span></code> checks whether
its content was written for the currently used computer and whether the
contained parallelization information regards the currently used HALCON
version, revision, and architecture. The attributes to suppress are
specified by passing any of the following values to
<a href="#GenParamValue"><i><code><span data-if="hdevelop" style="display:inline">GenParamValue</span><span data-if="c" style="display:none">GenParamValue</span><span data-if="cpp" style="display:none">GenParamValue</span><span data-if="com" style="display:none">GenParamValue</span><span data-if="dotnet" style="display:none">genParamValue</span><span data-if="python" style="display:none">gen_param_value</span></code></i></a>:
</p>
<dl class="generic">

<dt><b><i><span data-if="hdevelop" style="display:inline">'host'</span><span data-if="c" style="display:none">"host"</span><span data-if="cpp" style="display:none">"host"</span><span data-if="com" style="display:none">"host"</span><span data-if="dotnet" style="display:none">"host"</span><span data-if="python" style="display:none">"host"</span></i></b></dt>
<dd><p>
 the host name of the current machine
</p></dd>

<dt><b><i><span data-if="hdevelop" style="display:inline">'cpu_info'</span><span data-if="c" style="display:none">"cpu_info"</span><span data-if="cpp" style="display:none">"cpu_info"</span><span data-if="com" style="display:none">"cpu_info"</span><span data-if="dotnet" style="display:none">"cpu_info"</span><span data-if="python" style="display:none">"cpu_info"</span></i></b></dt>
<dd><p>
 the machine topology information
</p></dd>

<dt><b><i><span data-if="hdevelop" style="display:inline">'variant'</span><span data-if="c" style="display:none">"variant"</span><span data-if="cpp" style="display:none">"variant"</span><span data-if="com" style="display:none">"variant"</span><span data-if="dotnet" style="display:none">"variant"</span><span data-if="python" style="display:none">"variant"</span></i></b></dt>
<dd><p>
 the HALCON variant
</p></dd>

<dt><b><i><span data-if="hdevelop" style="display:inline">'version'</span><span data-if="c" style="display:none">"version"</span><span data-if="cpp" style="display:none">"version"</span><span data-if="com" style="display:none">"version"</span><span data-if="dotnet" style="display:none">"version"</span><span data-if="python" style="display:none">"version"</span></i></b></dt>
<dd><p>
 the HALCON version
</p></dd>

<dt><b><i><span data-if="hdevelop" style="display:inline">'revision'</span><span data-if="c" style="display:none">"revision"</span><span data-if="cpp" style="display:none">"revision"</span><span data-if="com" style="display:none">"revision"</span><span data-if="dotnet" style="display:none">"revision"</span><span data-if="python" style="display:none">"revision"</span></i></b></dt>
<dd><p>
 the HALCON revision
</p></dd>

<dt><b><i><span data-if="hdevelop" style="display:inline">'architecture'</span><span data-if="c" style="display:none">"architecture"</span><span data-if="cpp" style="display:none">"architecture"</span><span data-if="com" style="display:none">"architecture"</span><span data-if="dotnet" style="display:none">"architecture"</span><span data-if="python" style="display:none">"architecture"</span></i></b></dt>
<dd><p>
 the HALCON architecture
</p></dd>
</dl>
<p>
Multiple suppressions of attribute checks are possible.
</p>
</dd>

<dt><b><i><span data-if="hdevelop" style="display:inline">'mode'</span><span data-if="c" style="display:none">"mode"</span><span data-if="cpp" style="display:none">"mode"</span><span data-if="com" style="display:none">"mode"</span><span data-if="dotnet" style="display:none">"mode"</span><span data-if="python" style="display:none">"mode"</span></i></b></dt>
<dd>
<p>
 sets the way how the system's information gets
updated.
</p>
<dl class="generic">

<dt><b><i><span data-if="hdevelop" style="display:inline">'truncate'</span><span data-if="c" style="display:none">"truncate"</span><span data-if="cpp" style="display:none">"truncate"</span><span data-if="com" style="display:none">"truncate"</span><span data-if="dotnet" style="display:none">"truncate"</span><span data-if="python" style="display:none">"truncate"</span></i></b></dt>
<dd><p>
 for <a href="#GenParamValue"><i><code><span data-if="hdevelop" style="display:inline">GenParamValue</span><span data-if="c" style="display:none">GenParamValue</span><span data-if="cpp" style="display:none">GenParamValue</span><span data-if="com" style="display:none">GenParamValue</span><span data-if="dotnet" style="display:none">genParamValue</span><span data-if="python" style="display:none">gen_param_value</span></code></i></a> deletes
all the existing information before the new knowledge loaded from file
is added.
</p></dd>

<dt><b><i><span data-if="hdevelop" style="display:inline">'renew'</span><span data-if="c" style="display:none">"renew"</span><span data-if="cpp" style="display:none">"renew"</span><span data-if="com" style="display:none">"renew"</span><span data-if="dotnet" style="display:none">"renew"</span><span data-if="python" style="display:none">"renew"</span></i></b></dt>
<dd><p>
 overwrites existing knowledge and adds new one
(default).
</p></dd>

<dt><b><i><span data-if="hdevelop" style="display:inline">'append'</span><span data-if="c" style="display:none">"append"</span><span data-if="cpp" style="display:none">"append"</span><span data-if="com" style="display:none">"append"</span><span data-if="dotnet" style="display:none">"append"</span><span data-if="python" style="display:none">"append"</span></i></b></dt>
<dd><p>
 keeps all existing operator information and just
adds the knowledge not already contained.
</p></dd>

<dt><b><i><span data-if="hdevelop" style="display:inline">'nil'</span><span data-if="c" style="display:none">"nil"</span><span data-if="cpp" style="display:none">"nil"</span><span data-if="com" style="display:none">"nil"</span><span data-if="dotnet" style="display:none">"nil"</span><span data-if="python" style="display:none">"nil"</span></i></b></dt>
<dd><p>
 refuses  any updates but returns the
knowledge attributes in <a href="#Attributes"><i><code><span data-if="hdevelop" style="display:inline">Attributes</span><span data-if="c" style="display:none">Attributes</span><span data-if="cpp" style="display:none">Attributes</span><span data-if="com" style="display:none">Attributes</span><span data-if="dotnet" style="display:none">attributes</span><span data-if="python" style="display:none">attributes</span></code></i></a> and all 该算子s
contained in file in <a href="#OperatorNames"><i><code><span data-if="hdevelop" style="display:inline">OperatorNames</span><span data-if="c" style="display:none">OperatorNames</span><span data-if="cpp" style="display:none">OperatorNames</span><span data-if="com" style="display:none">OperatorNames</span><span data-if="dotnet" style="display:none">operatorNames</span><span data-if="python" style="display:none">operator_names</span></code></i></a>.
</p></dd>
</dl>
</dd>

<dt><b><i><span data-if="hdevelop" style="display:inline">'operator'</span><span data-if="c" style="display:none">"operator"</span><span data-if="cpp" style="display:none">"operator"</span><span data-if="com" style="display:none">"operator"</span><span data-if="dotnet" style="display:none">"operator"</span><span data-if="python" style="display:none">"operator"</span></i></b></dt>
<dd><p>
 denotes that the corresponding index value of
<a href="#GenParamValue"><i><code><span data-if="hdevelop" style="display:inline">GenParamValue</span><span data-if="c" style="display:none">GenParamValue</span><span data-if="cpp" style="display:none">GenParamValue</span><span data-if="com" style="display:none">GenParamValue</span><span data-if="dotnet" style="display:none">genParamValue</span><span data-if="python" style="display:none">gen_param_value</span></code></i></a> contains an operator name. Multiple definitions
of operators are possible. By default, information of any contained
operator is loaded.
</p></dd>

<dt><b><i><span data-if="hdevelop" style="display:inline">'iconic_type'</span><span data-if="c" style="display:none">"iconic_type"</span><span data-if="cpp" style="display:none">"iconic_type"</span><span data-if="com" style="display:none">"iconic_type"</span><span data-if="dotnet" style="display:none">"iconic_type"</span><span data-if="python" style="display:none">"iconic_type"</span></i></b></dt>
<dd><p>
 focuses on AOP information for a specific
iconic type, specified by following values of <a href="#GenParamValue"><i><code><span data-if="hdevelop" style="display:inline">GenParamValue</span><span data-if="c" style="display:none">GenParamValue</span><span data-if="cpp" style="display:none">GenParamValue</span><span data-if="com" style="display:none">GenParamValue</span><span data-if="dotnet" style="display:none">genParamValue</span><span data-if="python" style="display:none">gen_param_value</span></code></i></a>:
<i><span data-if="hdevelop" style="display:inline">'byte'</span><span data-if="c" style="display:none">"byte"</span><span data-if="cpp" style="display:none">"byte"</span><span data-if="com" style="display:none">"byte"</span><span data-if="dotnet" style="display:none">"byte"</span><span data-if="python" style="display:none">"byte"</span></i>,<i><span data-if="hdevelop" style="display:inline">'uint2'</span><span data-if="c" style="display:none">"uint2"</span><span data-if="cpp" style="display:none">"uint2"</span><span data-if="com" style="display:none">"uint2"</span><span data-if="dotnet" style="display:none">"uint2"</span><span data-if="python" style="display:none">"uint2"</span></i>,<i><span data-if="hdevelop" style="display:inline">'real'</span><span data-if="c" style="display:none">"real"</span><span data-if="cpp" style="display:none">"real"</span><span data-if="com" style="display:none">"real"</span><span data-if="dotnet" style="display:none">"real"</span><span data-if="python" style="display:none">"real"</span></i>,<i><span data-if="hdevelop" style="display:inline">'int1'</span><span data-if="c" style="display:none">"int1"</span><span data-if="cpp" style="display:none">"int1"</span><span data-if="com" style="display:none">"int1"</span><span data-if="dotnet" style="display:none">"int1"</span><span data-if="python" style="display:none">"int1"</span></i>,
<i><span data-if="hdevelop" style="display:inline">'int2'</span><span data-if="c" style="display:none">"int2"</span><span data-if="cpp" style="display:none">"int2"</span><span data-if="com" style="display:none">"int2"</span><span data-if="dotnet" style="display:none">"int2"</span><span data-if="python" style="display:none">"int2"</span></i>,<i><span data-if="hdevelop" style="display:inline">'int4'</span><span data-if="c" style="display:none">"int4"</span><span data-if="cpp" style="display:none">"int4"</span><span data-if="com" style="display:none">"int4"</span><span data-if="dotnet" style="display:none">"int4"</span><span data-if="python" style="display:none">"int4"</span></i>,<i><span data-if="hdevelop" style="display:inline">'int8'</span><span data-if="c" style="display:none">"int8"</span><span data-if="cpp" style="display:none">"int8"</span><span data-if="com" style="display:none">"int8"</span><span data-if="dotnet" style="display:none">"int8"</span><span data-if="python" style="display:none">"int8"</span></i>,<i><span data-if="hdevelop" style="display:inline">'direction'</span><span data-if="c" style="display:none">"direction"</span><span data-if="cpp" style="display:none">"direction"</span><span data-if="com" style="display:none">"direction"</span><span data-if="dotnet" style="display:none">"direction"</span><span data-if="python" style="display:none">"direction"</span></i>,
<i><span data-if="hdevelop" style="display:inline">'vector_field'</span><span data-if="c" style="display:none">"vector_field"</span><span data-if="cpp" style="display:none">"vector_field"</span><span data-if="com" style="display:none">"vector_field"</span><span data-if="dotnet" style="display:none">"vector_field"</span><span data-if="python" style="display:none">"vector_field"</span></i>,<i><span data-if="hdevelop" style="display:inline">'cyclic'</span><span data-if="c" style="display:none">"cyclic"</span><span data-if="cpp" style="display:none">"cyclic"</span><span data-if="com" style="display:none">"cyclic"</span><span data-if="dotnet" style="display:none">"cyclic"</span><span data-if="python" style="display:none">"cyclic"</span></i>,<i><span data-if="hdevelop" style="display:inline">'vector_field'</span><span data-if="c" style="display:none">"vector_field"</span><span data-if="cpp" style="display:none">"vector_field"</span><span data-if="com" style="display:none">"vector_field"</span><span data-if="dotnet" style="display:none">"vector_field"</span><span data-if="python" style="display:none">"vector_field"</span></i>,
<i><span data-if="hdevelop" style="display:inline">'complex'</span><span data-if="c" style="display:none">"complex"</span><span data-if="cpp" style="display:none">"complex"</span><span data-if="com" style="display:none">"complex"</span><span data-if="dotnet" style="display:none">"complex"</span><span data-if="python" style="display:none">"complex"</span></i>,<i><span data-if="hdevelop" style="display:inline">'region'</span><span data-if="c" style="display:none">"region"</span><span data-if="cpp" style="display:none">"region"</span><span data-if="com" style="display:none">"region"</span><span data-if="dotnet" style="display:none">"region"</span><span data-if="python" style="display:none">"region"</span></i>,<i><span data-if="hdevelop" style="display:inline">'xld'</span><span data-if="c" style="display:none">"xld"</span><span data-if="cpp" style="display:none">"xld"</span><span data-if="com" style="display:none">"xld"</span><span data-if="dotnet" style="display:none">"xld"</span><span data-if="python" style="display:none">"xld"</span></i>. Multiple definitions
of iconic types are possible.
</p></dd>
</dl>
<p>The names of updated operators are returned in <a href="#OperatorNames"><i><code><span data-if="hdevelop" style="display:inline">OperatorNames</span><span data-if="c" style="display:none">OperatorNames</span><span data-if="cpp" style="display:none">OperatorNames</span><span data-if="com" style="display:none">OperatorNames</span><span data-if="dotnet" style="display:none">operatorNames</span><span data-if="python" style="display:none">operator_names</span></code></i></a>,
the attributes of the read knowledge in <a href="#Attributes"><i><code><span data-if="hdevelop" style="display:inline">Attributes</span><span data-if="c" style="display:none">Attributes</span><span data-if="cpp" style="display:none">Attributes</span><span data-if="com" style="display:none">Attributes</span><span data-if="dotnet" style="display:none">attributes</span><span data-if="python" style="display:none">attributes</span></code></i></a>. The latter
tuple codes the following meaning by index beginning with index 0 in
corresponding order: host name, HALCON variant, HALCON version,
HALCON revision, HALCON architecture.
</p>
<h2 id="sec_execution">运行信息</h2>
<ul>
  <li>Multithreading type: exclusive (runs in parallel only with independent operators).</li>
<li>多线程作用域:全局(可以从任何线程调用)。</li>
  <li>未经并行化处理。</li>
</ul>
<h2 id="sec_parameters">参数表</h2>
  <div class="par">
<div class="parhead">
<span id="FileName" class="parname"><b><code><span data-if="hdevelop" style="display:inline">FileName</span><span data-if="c" style="display:none">FileName</span><span data-if="cpp" style="display:none">FileName</span><span data-if="com" style="display:none">FileName</span><span data-if="dotnet" style="display:none">fileName</span><span data-if="python" style="display:none">file_name</span></code></b> (input_control)  </span><span>filename.read <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">str</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (string)</span><span data-if="dotnet" style="display:none"> (<i>string</i>)</span><span data-if="cpp" style="display:none"> (<i>HString</i>)</span><span data-if="c" style="display:none"> (<i>char*</i>)</span></span>
</div>
<p class="pardesc">Name of knowledge file</p>
<p class="pardesc"><span class="parcat">Default:
      </span>
    <span data-if="hdevelop" style="display:inline">''</span>
    <span data-if="c" style="display:none">""</span>
    <span data-if="cpp" style="display:none">""</span>
    <span data-if="com" style="display:none">""</span>
    <span data-if="dotnet" style="display:none">""</span>
    <span data-if="python" style="display:none">""</span>
</p>
</div>
  <div class="par">
<div class="parhead">
<span id="GenParamName" class="parname"><b><code><span data-if="hdevelop" style="display:inline">GenParamName</span><span data-if="c" style="display:none">GenParamName</span><span data-if="cpp" style="display:none">GenParamName</span><span data-if="com" style="display:none">GenParamName</span><span data-if="dotnet" style="display:none">genParamName</span><span data-if="python" style="display:none">gen_param_name</span></code></b> (input_control)  </span><span>string(-array) <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">MaybeSequence[str]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (string)</span><span data-if="dotnet" style="display:none"> (<i>string</i>)</span><span data-if="cpp" style="display:none"> (<i>HString</i>)</span><span data-if="c" style="display:none"> (<i>char*</i>)</span></span>
</div>
<p class="pardesc">Parameter name</p>
<p class="pardesc"><span class="parcat">Default:
      </span>
    <span data-if="hdevelop" style="display:inline">'none'</span>
    <span data-if="c" style="display:none">"none"</span>
    <span data-if="cpp" style="display:none">"none"</span>
    <span data-if="com" style="display:none">"none"</span>
    <span data-if="dotnet" style="display:none">"none"</span>
    <span data-if="python" style="display:none">"none"</span>
</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span><span data-if="hdevelop" style="display:inline">'none'</span><span data-if="c" style="display:none">"none"</span><span data-if="cpp" style="display:none">"none"</span><span data-if="com" style="display:none">"none"</span><span data-if="dotnet" style="display:none">"none"</span><span data-if="python" style="display:none">"none"</span>, <span data-if="hdevelop" style="display:inline">'ignore_attrib'</span><span data-if="c" style="display:none">"ignore_attrib"</span><span data-if="cpp" style="display:none">"ignore_attrib"</span><span data-if="com" style="display:none">"ignore_attrib"</span><span data-if="dotnet" style="display:none">"ignore_attrib"</span><span data-if="python" style="display:none">"ignore_attrib"</span>, <span data-if="hdevelop" style="display:inline">'operator'</span><span data-if="c" style="display:none">"operator"</span><span data-if="cpp" style="display:none">"operator"</span><span data-if="com" style="display:none">"operator"</span><span data-if="dotnet" style="display:none">"operator"</span><span data-if="python" style="display:none">"operator"</span>, <span data-if="hdevelop" style="display:inline">'iconic_type'</span><span data-if="c" style="display:none">"iconic_type"</span><span data-if="cpp" style="display:none">"iconic_type"</span><span data-if="com" style="display:none">"iconic_type"</span><span data-if="dotnet" style="display:none">"iconic_type"</span><span data-if="python" style="display:none">"iconic_type"</span>, <span data-if="hdevelop" style="display:inline">'mode'</span><span data-if="c" style="display:none">"mode"</span><span data-if="cpp" style="display:none">"mode"</span><span data-if="com" style="display:none">"mode"</span><span data-if="dotnet" style="display:none">"mode"</span><span data-if="python" style="display:none">"mode"</span></p>
</div>
  <div class="par">
<div class="parhead">
<span id="GenParamValue" class="parname"><b><code><span data-if="hdevelop" style="display:inline">GenParamValue</span><span data-if="c" style="display:none">GenParamValue</span><span data-if="cpp" style="display:none">GenParamValue</span><span data-if="com" style="display:none">GenParamValue</span><span data-if="dotnet" style="display:none">genParamValue</span><span data-if="python" style="display:none">gen_param_value</span></code></b> (input_control)  </span><span>string(-array) <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">MaybeSequence[Union[str, int, float]]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (string / </span><span data-if="hdevelop" style="display:inline">integer / </span><span data-if="hdevelop" style="display:inline">real)</span><span data-if="dotnet" style="display:none"> (<i>string</i> / </span><span data-if="dotnet" style="display:none">int / </span><span data-if="dotnet" style="display:none">long / </span><span data-if="dotnet" style="display:none">double)</span><span data-if="cpp" style="display:none"> (<i>HString</i> / </span><span data-if="cpp" style="display:none">Hlong / </span><span data-if="cpp" style="display:none">double)</span><span data-if="c" style="display:none"> (<i>char*</i> / </span><span data-if="c" style="display:none">Hlong / </span><span data-if="c" style="display:none">double)</span></span>
</div>
<p class="pardesc">Parameter value</p>
<p class="pardesc"><span class="parcat">Number of elements:
      </span>GenParamName == GenParamValue</p>
<p class="pardesc"><span class="parcat">Default:
      </span>
    <span data-if="hdevelop" style="display:inline">'none'</span>
    <span data-if="c" style="display:none">"none"</span>
    <span data-if="cpp" style="display:none">"none"</span>
    <span data-if="com" style="display:none">"none"</span>
    <span data-if="dotnet" style="display:none">"none"</span>
    <span data-if="python" style="display:none">"none"</span>
</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span><span data-if="hdevelop" style="display:inline">'none'</span><span data-if="c" style="display:none">"none"</span><span data-if="cpp" style="display:none">"none"</span><span data-if="com" style="display:none">"none"</span><span data-if="dotnet" style="display:none">"none"</span><span data-if="python" style="display:none">"none"</span>, <span data-if="hdevelop" style="display:inline">'host_name'</span><span data-if="c" style="display:none">"host_name"</span><span data-if="cpp" style="display:none">"host_name"</span><span data-if="com" style="display:none">"host_name"</span><span data-if="dotnet" style="display:none">"host_name"</span><span data-if="python" style="display:none">"host_name"</span>, <span data-if="hdevelop" style="display:inline">'variant'</span><span data-if="c" style="display:none">"variant"</span><span data-if="cpp" style="display:none">"variant"</span><span data-if="com" style="display:none">"variant"</span><span data-if="dotnet" style="display:none">"variant"</span><span data-if="python" style="display:none">"variant"</span>, <span data-if="hdevelop" style="display:inline">'architecture'</span><span data-if="c" style="display:none">"architecture"</span><span data-if="cpp" style="display:none">"architecture"</span><span data-if="com" style="display:none">"architecture"</span><span data-if="dotnet" style="display:none">"architecture"</span><span data-if="python" style="display:none">"architecture"</span>, <span data-if="hdevelop" style="display:inline">'version'</span><span data-if="c" style="display:none">"version"</span><span data-if="cpp" style="display:none">"version"</span><span data-if="com" style="display:none">"version"</span><span data-if="dotnet" style="display:none">"version"</span><span data-if="python" style="display:none">"version"</span>, <span data-if="hdevelop" style="display:inline">'revision'</span><span data-if="c" style="display:none">"revision"</span><span data-if="cpp" style="display:none">"revision"</span><span data-if="com" style="display:none">"revision"</span><span data-if="dotnet" style="display:none">"revision"</span><span data-if="python" style="display:none">"revision"</span>, <span data-if="hdevelop" style="display:inline">'byte'</span><span data-if="c" style="display:none">"byte"</span><span data-if="cpp" style="display:none">"byte"</span><span data-if="com" style="display:none">"byte"</span><span data-if="dotnet" style="display:none">"byte"</span><span data-if="python" style="display:none">"byte"</span>, <span data-if="hdevelop" style="display:inline">'int1'</span><span data-if="c" style="display:none">"int1"</span><span data-if="cpp" style="display:none">"int1"</span><span data-if="com" style="display:none">"int1"</span><span data-if="dotnet" style="display:none">"int1"</span><span data-if="python" style="display:none">"int1"</span>, <span data-if="hdevelop" style="display:inline">'int2'</span><span data-if="c" style="display:none">"int2"</span><span data-if="cpp" style="display:none">"int2"</span><span data-if="com" style="display:none">"int2"</span><span data-if="dotnet" style="display:none">"int2"</span><span data-if="python" style="display:none">"int2"</span>, <span data-if="hdevelop" style="display:inline">'uint2'</span><span data-if="c" style="display:none">"uint2"</span><span data-if="cpp" style="display:none">"uint2"</span><span data-if="com" style="display:none">"uint2"</span><span data-if="dotnet" style="display:none">"uint2"</span><span data-if="python" style="display:none">"uint2"</span>, <span data-if="hdevelop" style="display:inline">'int4'</span><span data-if="c" style="display:none">"int4"</span><span data-if="cpp" style="display:none">"int4"</span><span data-if="com" style="display:none">"int4"</span><span data-if="dotnet" style="display:none">"int4"</span><span data-if="python" style="display:none">"int4"</span>, <span data-if="hdevelop" style="display:inline">'int8'</span><span data-if="c" style="display:none">"int8"</span><span data-if="cpp" style="display:none">"int8"</span><span data-if="com" style="display:none">"int8"</span><span data-if="dotnet" style="display:none">"int8"</span><span data-if="python" style="display:none">"int8"</span>, <span data-if="hdevelop" style="display:inline">'direction'</span><span data-if="c" style="display:none">"direction"</span><span data-if="cpp" style="display:none">"direction"</span><span data-if="com" style="display:none">"direction"</span><span data-if="dotnet" style="display:none">"direction"</span><span data-if="python" style="display:none">"direction"</span>, <span data-if="hdevelop" style="display:inline">'cyclic'</span><span data-if="c" style="display:none">"cyclic"</span><span data-if="cpp" style="display:none">"cyclic"</span><span data-if="com" style="display:none">"cyclic"</span><span data-if="dotnet" style="display:none">"cyclic"</span><span data-if="python" style="display:none">"cyclic"</span>, <span data-if="hdevelop" style="display:inline">'vector_field'</span><span data-if="c" style="display:none">"vector_field"</span><span data-if="cpp" style="display:none">"vector_field"</span><span data-if="com" style="display:none">"vector_field"</span><span data-if="dotnet" style="display:none">"vector_field"</span><span data-if="python" style="display:none">"vector_field"</span>, <span data-if="hdevelop" style="display:inline">'complex'</span><span data-if="c" style="display:none">"complex"</span><span data-if="cpp" style="display:none">"complex"</span><span data-if="com" style="display:none">"complex"</span><span data-if="dotnet" style="display:none">"complex"</span><span data-if="python" style="display:none">"complex"</span>, <span data-if="hdevelop" style="display:inline">'region'</span><span data-if="c" style="display:none">"region"</span><span data-if="cpp" style="display:none">"region"</span><span data-if="com" style="display:none">"region"</span><span data-if="dotnet" style="display:none">"region"</span><span data-if="python" style="display:none">"region"</span>, <span data-if="hdevelop" style="display:inline">'xld'</span><span data-if="c" style="display:none">"xld"</span><span data-if="cpp" style="display:none">"xld"</span><span data-if="com" style="display:none">"xld"</span><span data-if="dotnet" style="display:none">"xld"</span><span data-if="python" style="display:none">"xld"</span>, <span data-if="hdevelop" style="display:inline">'xld_cont'</span><span data-if="c" style="display:none">"xld_cont"</span><span data-if="cpp" style="display:none">"xld_cont"</span><span data-if="com" style="display:none">"xld_cont"</span><span data-if="dotnet" style="display:none">"xld_cont"</span><span data-if="python" style="display:none">"xld_cont"</span>, <span data-if="hdevelop" style="display:inline">'xld_poly'</span><span data-if="c" style="display:none">"xld_poly"</span><span data-if="cpp" style="display:none">"xld_poly"</span><span data-if="com" style="display:none">"xld_poly"</span><span data-if="dotnet" style="display:none">"xld_poly"</span><span data-if="python" style="display:none">"xld_poly"</span>, <span data-if="hdevelop" style="display:inline">'nil'</span><span data-if="c" style="display:none">"nil"</span><span data-if="cpp" style="display:none">"nil"</span><span data-if="com" style="display:none">"nil"</span><span data-if="dotnet" style="display:none">"nil"</span><span data-if="python" style="display:none">"nil"</span>, <span data-if="hdevelop" style="display:inline">'truncate'</span><span data-if="c" style="display:none">"truncate"</span><span data-if="cpp" style="display:none">"truncate"</span><span data-if="com" style="display:none">"truncate"</span><span data-if="dotnet" style="display:none">"truncate"</span><span data-if="python" style="display:none">"truncate"</span>, <span data-if="hdevelop" style="display:inline">'replace'</span><span data-if="c" style="display:none">"replace"</span><span data-if="cpp" style="display:none">"replace"</span><span data-if="com" style="display:none">"replace"</span><span data-if="dotnet" style="display:none">"replace"</span><span data-if="python" style="display:none">"replace"</span>, <span data-if="hdevelop" style="display:inline">'renew'</span><span data-if="c" style="display:none">"renew"</span><span data-if="cpp" style="display:none">"renew"</span><span data-if="com" style="display:none">"renew"</span><span data-if="dotnet" style="display:none">"renew"</span><span data-if="python" style="display:none">"renew"</span>, <span data-if="hdevelop" style="display:inline">'append'</span><span data-if="c" style="display:none">"append"</span><span data-if="cpp" style="display:none">"append"</span><span data-if="com" style="display:none">"append"</span><span data-if="dotnet" style="display:none">"append"</span><span data-if="python" style="display:none">"append"</span></p>
</div>
  <div class="par">
<div class="parhead">
<span id="Attributes" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Attributes</span><span data-if="c" style="display:none">Attributes</span><span data-if="cpp" style="display:none">Attributes</span><span data-if="com" style="display:none">Attributes</span><span data-if="dotnet" style="display:none">attributes</span><span data-if="python" style="display:none">attributes</span></code></b> (output_control)  </span><span>string-array <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">Sequence[str]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (string)</span><span data-if="dotnet" style="display:none"> (<i>string</i>)</span><span data-if="cpp" style="display:none"> (<i>HString</i>)</span><span data-if="c" style="display:none"> (<i>char*</i>)</span></span>
</div>
<p class="pardesc">Knowledge attributes</p>
</div>
  <div class="par">
<div class="parhead">
<span id="OperatorNames" class="parname"><b><code><span data-if="hdevelop" style="display:inline">OperatorNames</span><span data-if="c" style="display:none">OperatorNames</span><span data-if="cpp" style="display:none">OperatorNames</span><span data-if="com" style="display:none">OperatorNames</span><span data-if="dotnet" style="display:none">operatorNames</span><span data-if="python" style="display:none">operator_names</span></code></b> (output_control)  </span><span>string(-array) <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">Sequence[str]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (string)</span><span data-if="dotnet" style="display:none"> (<i>string</i>)</span><span data-if="cpp" style="display:none"> (<i>HString</i>)</span><span data-if="c" style="display:none"> (<i>char*</i>)</span></span>
</div>
<p class="pardesc">Updated Operators</p>
</div>
<h2 id="sec_result">结果</h2>
<p><code><span data-if="hdevelop" style="display:inline">read_aop_knowledge</span><span data-if="c" style="display:none">read_aop_knowledge</span><span data-if="cpp" style="display:none">ReadAopKnowledge</span><span data-if="com" style="display:none">ReadAopKnowledge</span><span data-if="dotnet" style="display:none">ReadAopKnowledge</span><span data-if="python" style="display:none">read_aop_knowledge</span></code> returns <TT>2</TT> (
      <TT>H_MSG_TRUE</TT>)
     if all parameters are correct and
the file could be read. 如有必要，将引发异常。
</p>
<h2 id="sec_module">模块</h2>
<p>
Foundation</p>
<!--OP_REF_FOOTER_START-->
<hr>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<div class="footer">
<div class="copyright">HALCON算子参考手册 Copyright © 2015-2023 51Halcon</div>
</div>
</div>
</body>
</html>
